Autogenerated HTML docs for v1.6.0.2-287-g3791f
diff --git a/technical/api-allocation-growing.html b/technical/api-allocation-growing.html index 208153f..10cdd99 100644 --- a/technical/api-allocation-growing.html +++ b/technical/api-allocation-growing.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>allocation growing API</title> </head> @@ -263,9 +311,9 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Dynamically growing an array using realloc() is error prone and boring.</p> -<p>Define your array with:</p> -<ul> +<div class="para"><p>Dynamically growing an array using realloc() is error prone and boring.</p></div> +<div class="para"><p>Define your array with:</p></div> +<div class="ilist"><ul> <li> <p> a pointer (<tt>ary</tt>) that points at the array, initialized to <tt>NULL</tt>; @@ -283,10 +331,10 @@ array currently has, initialized to <tt>0</tt>. </p> </li> -</ul> -<p>Then before adding <tt>n`th element to the array, call `ALLOC_GROW(ary, n, +</ul></div> +<div class="para"><p>Then before adding <tt>n`th element to the array, call `ALLOC_GROW(ary, n, alloc)</tt>. This ensures that the array can hold at least <tt>n</tt> elements by -calling <tt>realloc(3)</tt> and adjusting <tt>alloc</tt> variable.</p> +calling <tt>realloc(3)</tt> and adjusting <tt>alloc</tt> variable.</p></div> <div class="listingblock"> <div class="content"> <pre><tt>sometype *ary; @@ -301,12 +349,12 @@ ALLOC_GROW(ary, nr + 1, alloc); ary[nr++] = value you like;</tt></pre> </div></div> -<p>You are responsible for updating the <tt>nr</tt> variable.</p> +<div class="para"><p>You are responsible for updating the <tt>nr</tt> variable.</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:16 UTC +Last updated 2008-09-19 06:33:26 UTC </div> </div> </body> diff --git a/technical/api-builtin.html b/technical/api-builtin.html index ca82b85..21fc35f 100644 --- a/technical/api-builtin.html +++ b/technical/api-builtin.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>builtin API</title> </head> @@ -261,11 +309,11 @@ <div id="header"> <h1>builtin API</h1> </div> -<h2>Adding a new built-in</h2> +<h2 id="_adding_a_new_built_in">Adding a new built-in</h2> <div class="sectionbody"> -<p>There are 4 things to do to add a built-in command implementation to -git:</p> -<ol> +<div class="para"><p>There are 4 things to do to add a built-in command implementation to +git:</p></div> +<div class="olist"><ol> <li> <p> Define the implementation of the built-in command <tt>foo</tt> with @@ -290,8 +338,8 @@ <div class="content"> <pre><tt>{ "foo", cmd_foo, <options> },</tt></pre> </div></div> -<p>where options is the bitwise-or of:</p> -<dl> +<div class="para"><p>where options is the bitwise-or of:</p></div> +<div class="vlist"><dl> <dt> <tt>RUN_SETUP</tt> </dt> @@ -322,16 +370,16 @@ This makes only sense when <tt>RUN_SETUP</tt> is also set. </p> </dd> -</dl> +</dl></div> </li> <li> <p> Add <tt>builtin-foo.o</tt> to <tt>BUILTIN_OBJS</tt> in <tt>Makefile</tt>. </p> </li> -</ol> -<p>Additionally, if <tt>foo</tt> is a new command, there are 3 more things to do:</p> -<ol> +</ol></div> +<div class="para"><p>Additionally, if <tt>foo</tt> is a new command, there are 3 more things to do:</p></div> +<div class="olist"><ol> <li> <p> Add tests to <tt>t/</tt> directory. @@ -347,25 +395,25 @@ Add an entry for <tt>git-foo</tt> to <tt>command-list.txt</tt>. </p> </li> -</ol> +</ol></div> </div> -<h2>How a built-in is called</h2> +<h2 id="_how_a_built_in_is_called">How a built-in is called</h2> <div class="sectionbody"> -<p>The implementation <tt>cmd_foo()</tt> takes three parameters, <tt>argc</tt>, <tt>argv, +<div class="para"><p>The implementation <tt>cmd_foo()</tt> takes three parameters, <tt>argc</tt>, <tt>argv, and `prefix</tt>. The first two are similar to what <tt>main()</tt> of a -standalone command would be called with.</p> -<p>When <tt>RUN_SETUP</tt> is specified in the <tt>commands[]</tt> table, and when you +standalone command would be called with.</p></div> +<div class="para"><p>When <tt>RUN_SETUP</tt> is specified in the <tt>commands[]</tt> table, and when you were started from a subdirectory of the work tree, <tt>cmd_foo()</tt> is called after chdir(2) to the top of the work tree, and <tt>prefix</tt> gets the path to the subdirectory the command started from. This allows you to convert a user-supplied pathname (typically relative to that directory) -to a pathname relative to the top of the work tree.</p> -<p>The return value from <tt>cmd_foo()</tt> becomes the exit status of the -command.</p> +to a pathname relative to the top of the work tree.</p></div> +<div class="para"><p>The return value from <tt>cmd_foo()</tt> becomes the exit status of the +command.</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:16 UTC +Last updated 2008-09-19 06:33:26 UTC </div> </div> </body> diff --git a/technical/api-decorate.html b/technical/api-decorate.html index 302a969..d4b856e 100644 --- a/technical/api-decorate.html +++ b/technical/api-decorate.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>decorate API</title> </head> @@ -263,13 +311,13 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <decorate.h></p> -<p>(Linus)</p> +<div class="para"><p>Talk about <decorate.h></p></div> +<div class="para"><p>(Linus)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:17 UTC +Last updated 2008-09-19 06:33:27 UTC </div> </div> </body> diff --git a/technical/api-diff.html b/technical/api-diff.html index 72edeee..6da799b 100644 --- a/technical/api-diff.html +++ b/technical/api-diff.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>diff API</title> </head> @@ -263,13 +311,13 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The diff API is for programs that compare two sets of files (e.g. two +<div class="para"><p>The diff API is for programs that compare two sets of files (e.g. two trees, one tree and the index) and present the found difference in various ways. The calling program is responsible for feeding the API pairs of files, one from the "old" set and the corresponding one from "new" set, that are different. The library called through this API is -called diffcore, and is responsible for two things.</p> -<ul> +called diffcore, and is responsible for two things.</p></div> +<div class="ilist"><ul> <li> <p> finding total rewrites (<tt>-B</tt>), renames (<tt>-M</tt>) and copies (<tt>-C</tt>), and @@ -282,12 +330,12 @@ caller. </p> </li> -</ul> +</ul></div> </div> </div> -<h2>Calling sequence</h2> +<h2 id="_calling_sequence">Calling sequence</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> Prepare <tt>struct diff_options</tt> to record the set of diff options, and @@ -330,47 +378,47 @@ Calling <tt>diff_flush()</tt> will produce the output. </p> </li> -</ul> +</ul></div> </div> -<h2>Data structures</h2> +<h2 id="_data_structures">Data structures</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> <tt>struct diff_filespec</tt> </p> </li> -</ul> -<p>This is the internal representation for a single file (blob). It +</ul></div> +<div class="para"><p>This is the internal representation for a single file (blob). It records the blob object name (if known — for a work tree file it typically is a NUL SHA-1), filemode and pathname. This is what the <tt>diff_addremove()</tt>, <tt>diff_change()</tt> and <tt>diff_unmerged()</tt> synthesize and -feed <tt>diff_queue()</tt> function with.</p> -<ul> +feed <tt>diff_queue()</tt> function with.</p></div> +<div class="ilist"><ul> <li> <p> <tt>struct diff_filepair</tt> </p> </li> -</ul> -<p>This records a pair of <tt>struct diff_filespec</tt>; the filespec for a file +</ul></div> +<div class="para"><p>This records a pair of <tt>struct diff_filespec</tt>; the filespec for a file in the "old" set (i.e. preimage) is called <tt>one</tt>, and the filespec for a file in the "new" set (i.e. postimage) is called <tt>two</tt>. A change that represents file creation has NULL in <tt>one</tt>, and file deletion has NULL -in <tt>two</tt>.</p> -<p>A <tt>filepair</tt> starts pointing at <tt>one</tt> and <tt>two</tt> that are from the same +in <tt>two</tt>.</p></div> +<div class="para"><p>A <tt>filepair</tt> starts pointing at <tt>one</tt> and <tt>two</tt> that are from the same filename, but <tt>diffcore_std()</tt> can break pairs and match component filespecs with other filespecs from a different filepair to form new -filepair. This is called <em>rename detection</em>.</p> -<ul> +filepair. This is called <em>rename detection</em>.</p></div> +<div class="ilist"><ul> <li> <p> <tt>struct diff_queue</tt> </p> </li> -</ul> -<p>This is a collection of filepairs. Notable members are:</p> -<dl> +</ul></div> +<div class="para"><p>This is a collection of filepairs. Notable members are:</p></div> +<div class="vlist"><dl> <dt> <tt>queue</tt> </dt> @@ -395,19 +443,19 @@ <p> The number of elements in the <tt>queue</tt> array. </p> -<ul> +<div class="ilist"><ul> <li> <p> <tt>struct diff_options</tt> </p> </li> -</ul> +</ul></div> </dd> -</dl> -<p>This describes the set of options the calling program wants to affect -the operation of diffcore library with.</p> -<p>Notable members are:</p> -<dl> +</dl></div> +<div class="para"><p>This describes the set of options the calling program wants to affect +the operation of diffcore library with.</p></div> +<div class="para"><p>Notable members are:</p></div> +<div class="vlist"><dl> <dt> <tt>output_format</tt> </dt> @@ -461,7 +509,7 @@ operation, but some do not have anything to do with the diffcore library. </p> -<dl> +<div class="vlist"><dl> <dt> BINARY, TEXT </dt> @@ -575,14 +623,14 @@ and postimage set. </p> </dd> -</dl> +</dl></div> </dd> -</dl> -<p>(JC)</p> +</dl></div> +<div class="para"><p>(JC)</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:17 UTC +Last updated 2008-09-19 06:33:27 UTC </div> </div> </body> diff --git a/technical/api-directory-listing.html b/technical/api-directory-listing.html index 439d78e..4a283e3 100644 --- a/technical/api-directory-listing.html +++ b/technical/api-directory-listing.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>directory listing API</title> </head> @@ -263,17 +311,17 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The directory listing API is used to enumerate paths in the work tree, +<div class="para"><p>The directory listing API is used to enumerate paths in the work tree, optionally taking <tt>.git/info/exclude</tt> and <tt>.gitignore</tt> files per -directory into account.</p> +directory into account.</p></div> </div> </div> -<h2>Data structure</h2> +<h2 id="_data_structure">Data structure</h2> <div class="sectionbody"> -<p><tt>struct dir_struct</tt> structure is used to pass directory traversal +<div class="para"><p><tt>struct dir_struct</tt> structure is used to pass directory traversal options to the library and to record the paths discovered. The notable -options are:</p> -<dl> +options are:</p></div> +<div class="vlist"><dl> <dt> <tt>exclude_per_dir</tt> </dt> @@ -353,11 +401,11 @@ Internal use; keeps track of allocation of <tt>entries[]</tt> array. </p> </dd> -</dl> +</dl></div> </div> -<h2>Calling sequence</h2> +<h2 id="_calling_sequence">Calling sequence</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> Prepare <tt>struct dir_struct dir</tt> and clear it with <tt>memset(&dir, 0, @@ -388,12 +436,12 @@ Use <tt>dir.entries[]</tt>. </p> </li> -</ul> -<p>(JC)</p> +</ul></div> +<div class="para"><p>(JC)</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:17 UTC +Last updated 2008-09-19 06:33:28 UTC </div> </div> </body> diff --git a/technical/api-gitattributes.html b/technical/api-gitattributes.html index 23a1c43..1c75522 100644 --- a/technical/api-gitattributes.html +++ b/technical/api-gitattributes.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>gitattributes API</title> </head> @@ -263,13 +311,13 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>gitattributes mechanism gives a uniform way to associate various -attributes to set of paths.</p> +<div class="para"><p>gitattributes mechanism gives a uniform way to associate various +attributes to set of paths.</p></div> </div> </div> -<h2>Data Structure</h2> +<h2 id="_data_structure">Data Structure</h2> <div class="sectionbody"> -<dl> +<div class="vlist"><dl> <dt> <tt>struct git_attr</tt> </dt> @@ -290,11 +338,11 @@ to <tt>git_checkattr()</tt> function, and receives the results. </p> </dd> -</dl> +</dl></div> </div> -<h2>Calling Sequence</h2> +<h2 id="_calling_sequence">Calling Sequence</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> Prepare an array of <tt>struct git_attr_check</tt> to define the list of @@ -313,14 +361,14 @@ the array is defined for the path. </p> </li> -</ul> +</ul></div> </div> -<h2>Attribute Values</h2> +<h2 id="_attribute_values">Attribute Values</h2> <div class="sectionbody"> -<p>An attribute for a path can be in one of four states: Set, Unset, +<div class="para"><p>An attribute for a path can be in one of four states: Set, Unset, Unspecified or set to a string, and <tt>.value</tt> member of <tt>struct -git_attr_check</tt> records it. There are three macros to check these:</p> -<dl> +git_attr_check</tt> records it. There are three macros to check these:</p></div> +<div class="vlist"><dl> <dt> <tt>ATTR_TRUE()</tt> </dt> @@ -345,14 +393,14 @@ Returns true if the attribute is Unspecified for the path. </p> </dd> -</dl> -<p>If none of the above returns true, <tt>.value</tt> member points at a string -value of the attribute for the path.</p> +</dl></div> +<div class="para"><p>If none of the above returns true, <tt>.value</tt> member points at a string +value of the attribute for the path.</p></div> </div> -<h2>Example</h2> +<h2 id="_example">Example</h2> <div class="sectionbody"> -<p>To see how attributes "crlf" and "indent" are set for different paths.</p> -<ol> +<div class="para"><p>To see how attributes "crlf" and "indent" are set for different paths.</p></div> +<div class="olist"><ol> <li> <p> Prepare an array of <tt>struct git_attr_check</tt> with two elements (because @@ -360,7 +408,7 @@ pointers to <tt>struct git_attr</tt> obtained by calling <tt>git_attr()</tt>: </p> </li> -</ol> +</ol></div> <div class="listingblock"> <div class="content"> <pre><tt>static struct git_attr_check check[2]; @@ -372,13 +420,13 @@ check[1].attr = git_attr("ident", 5); }</tt></pre> </div></div> -<ol> +<div class="olist"><ol> <li> <p> Call <tt>git_checkattr()</tt> with the prepared array of <tt>struct git_attr_check</tt>: </p> </li> -</ol> +</ol></div> <div class="listingblock"> <div class="content"> <pre><tt> const char *path; @@ -386,13 +434,13 @@ setup_check(); git_checkattr(path, ARRAY_SIZE(check), check);</tt></pre> </div></div> -<ol> +<div class="olist"><ol> <li> <p> Act on <tt>.value</tt> member of the result, left in <tt>check[]</tt>: </p> </li> -</ol> +</ol></div> <div class="listingblock"> <div class="content"> <pre><tt> const char *value = check[0].value; @@ -413,11 +461,11 @@ ... }</tt></pre> </div></div> -<p>(JC)</p> +<div class="para"><p>(JC)</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:18 UTC +Last updated 2008-09-19 06:33:28 UTC </div> </div> </body> diff --git a/technical/api-grep.html b/technical/api-grep.html index a92769d..6383d00 100644 --- a/technical/api-grep.html +++ b/technical/api-grep.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>grep API</title> </head> @@ -263,20 +311,20 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <grep.h>, things like:</p> -<ul> +<div class="para"><p>Talk about <grep.h>, things like:</p></div> +<div class="ilist"><ul> <li> <p> grep_buffer() </p> </li> -</ul> -<p>(JC)</p> +</ul></div> +<div class="para"><p>(JC)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:18 UTC +Last updated 2008-09-19 06:33:28 UTC </div> </div> </body> diff --git a/technical/api-hash.html b/technical/api-hash.html index f7eee35..051c185 100644 --- a/technical/api-hash.html +++ b/technical/api-hash.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>hash API</title> </head> @@ -263,13 +311,13 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <hash.h></p> -<p>(Linus)</p> +<div class="para"><p>Talk about <hash.h></p></div> +<div class="para"><p>(Linus)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:18 UTC +Last updated 2008-09-19 06:33:29 UTC </div> </div> </body> diff --git a/technical/api-history-graph.html b/technical/api-history-graph.html index e13c691..0cef745 100644 --- a/technical/api-history-graph.html +++ b/technical/api-history-graph.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>history graph API</title> </head> @@ -263,14 +311,14 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The graph API is used to draw a text-based representation of the commit -history. The API generates the graph in a line-by-line fashion.</p> +<div class="para"><p>The graph API is used to draw a text-based representation of the commit +history. The API generates the graph in a line-by-line fashion.</p></div> </div> </div> -<h2>Functions</h2> +<h2 id="_functions">Functions</h2> <div class="sectionbody"> -<p>Core functions:</p> -<ul> +<div class="para"><p>Core functions:</p></div> +<div class="ilist"><ul> <li> <p> <tt>graph_init()</tt> creates a new <tt>struct git_graph</tt> @@ -311,12 +359,12 @@ the graph was omitted. </p> </li> -</ul> -<p>The following utility functions are wrappers around <tt>graph_next_line()</tt> and +</ul></div> +<div class="para"><p>The following utility functions are wrappers around <tt>graph_next_line()</tt> and <tt>graph_is_commit_finished()</tt>. They always print the output to stdout. They can all be called with a NULL graph argument, in which case no graph -output will be printed.</p> -<ul> +output will be printed.</p></div> +<div class="ilist"><ul> <li> <p> <tt>graph_show_commit()</tt> calls <tt>graph_next_line()</tt> until it returns non-zero. @@ -365,16 +413,16 @@ end in a newline if and only if the strbuf ends in a newline. </p> </li> -</ul> +</ul></div> </div> -<h2>Data structure</h2> +<h2 id="_data_structure">Data structure</h2> <div class="sectionbody"> -<p><tt>struct git_graph</tt> is an opaque data type used to store the current graph -state.</p> +<div class="para"><p><tt>struct git_graph</tt> is an opaque data type used to store the current graph +state.</p></div> </div> -<h2>Calling sequence</h2> +<h2 id="_calling_sequence">Calling sequence</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> Create a <tt>struct git_graph</tt> by calling <tt>graph_init()</tt>. When using the @@ -401,11 +449,11 @@ alongside the graph output. </p> </li> -</ul> +</ul></div> </div> -<h2>Limitations</h2> +<h2 id="_limitations">Limitations</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> <tt>graph_update()</tt> must be called with commits in topological order. It should @@ -420,8 +468,8 @@ on all parents of that commit. Parents must not be skipped, or the graph output will appear incorrect. </p> -<p><tt>graph_update()</tt> may be used on a pruned set of commits only if the parent list -has been rewritten so as to include only ancestors from the pruned set.</p> +<div class="para"><p><tt>graph_update()</tt> may be used on a pruned set of commits only if the parent list +has been rewritten so as to include only ancestors from the pruned set.</p></div> </li> <li> <p> @@ -430,9 +478,9 @@ (efficient) mechanism to find the children of a commit. </p> </li> -</ul> +</ul></div> </div> -<h2>Sample usage</h2> +<h2 id="_sample_usage">Sample usage</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> @@ -460,11 +508,11 @@ graph_release(graph);</tt></pre> </div></div> </div> -<h2>Sample output</h2> +<h2 id="_sample_output">Sample output</h2> <div class="sectionbody"> -<p>The following is an example of the output from the graph API. This output does +<div class="para"><p>The following is an example of the output from the graph API. This output does not include any commit summary information—callers are responsible for -outputting that information, if desired.</p> +outputting that information, if desired.</p></div> <div class="listingblock"> <div class="content"> <pre><tt>* @@ -501,7 +549,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:19 UTC +Last updated 2008-09-19 06:33:29 UTC </div> </div> </body> diff --git a/technical/api-in-core-index.html b/technical/api-in-core-index.html index d9558cc..309dc9c 100644 --- a/technical/api-in-core-index.html +++ b/technical/api-in-core-index.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>in-core index API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <read-cache.c> and <cache-tree.c>, things like:</p> -<ul> +<div class="para"><p>Talk about <read-cache.c> and <cache-tree.c>, things like:</p></div> +<div class="ilist"><ul> <li> <p> cache -> the_index macros @@ -331,13 +379,13 @@ cache_tree_update() </p> </li> -</ul> -<p>(JC, Linus)</p> +</ul></div> +<div class="para"><p>(JC, Linus)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:19 UTC +Last updated 2008-09-19 06:33:29 UTC </div> </div> </body> diff --git a/technical/api-lockfile.html b/technical/api-lockfile.html index ab222b7..1c6982a 100644 --- a/technical/api-lockfile.html +++ b/technical/api-lockfile.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>lockfile API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The lockfile API serves two purposes:</p> -<ul> +<div class="para"><p>The lockfile API serves two purposes:</p></div> +<div class="ilist"><ul> <li> <p> Mutual exclusion. When we write out a new index file, first @@ -286,12 +334,12 @@ when the program dies on a signal. </p> </li> -</ul> +</ul></div> </div> </div> -<h2>The functions</h2> +<h2 id="_the_functions">The functions</h2> <div class="sectionbody"> -<dl> +<div class="vlist"><dl> <dt> hold_lock_file_for_update </dt> @@ -339,15 +387,15 @@ a negative value on failure to close(2). </p> </dd> -</dl> -<p>Because the structure is used in an <tt>atexit(3)</tt> handler, its +</dl></div> +<div class="para"><p>Because the structure is used in an <tt>atexit(3)</tt> handler, its storage has to stay throughout the life of the program. It -cannot be an auto variable allocated on the stack.</p> -<p>Call <tt>commit_lock_file()</tt> or <tt>rollback_lock_file()</tt> when you are +cannot be an auto variable allocated on the stack.</p></div> +<div class="para"><p>Call <tt>commit_lock_file()</tt> or <tt>rollback_lock_file()</tt> when you are done writing to the file descriptor. If you do not call either and simply <tt>exit(3)</tt> from the program, an <tt>atexit(3)</tt> handler -will close and remove the lockfile.</p> -<p>If you need to close the file descriptor you obtained from +will close and remove the lockfile.</p></div> +<div class="para"><p>If you need to close the file descriptor you obtained from <tt>hold_lock_file_for_update</tt> function yourself, do so by calling <tt>close_lock_file()</tt>. You should never call <tt>close(2)</tt> yourself! Otherwise the <tt>struct @@ -357,11 +405,11 @@ <tt>close(2)</tt>. Worse yet, if you <tt>close(2)</tt>, open another file descriptor for completely different purpose, and then call <tt>commit_lock_file()</tt> or <tt>rollback_lock_file()</tt>, they may close -that unrelated file descriptor.</p> +that unrelated file descriptor.</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:19 UTC +Last updated 2008-09-19 06:33:30 UTC </div> </div> </body> diff --git a/technical/api-object-access.html b/technical/api-object-access.html index e269607..c341222 100644 --- a/technical/api-object-access.html +++ b/technical/api-object-access.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>object access API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <sha1_file.c> and <object.h> family, things like</p> -<ul> +<div class="para"><p>Talk about <sha1_file.c> and <object.h> family, things like</p></div> +<div class="ilist"><ul> <li> <p> read_sha1_file() @@ -305,13 +353,13 @@ Use of object flags </p> </li> -</ul> -<p>(JC, Shawn, Daniel, Dscho, Linus)</p> +</ul></div> +<div class="para"><p>(JC, Shawn, Daniel, Dscho, Linus)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:20 UTC +Last updated 2008-09-19 06:33:30 UTC </div> </div> </body> diff --git a/technical/api-parse-options.html b/technical/api-parse-options.html index da2d340..d71a551 100644 --- a/technical/api-parse-options.html +++ b/technical/api-parse-options.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>parse-options API</title> </head> @@ -263,17 +311,17 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The parse-options API is used to parse and massage options in git -and to provide a usage help with consistent look.</p> +<div class="para"><p>The parse-options API is used to parse and massage options in git +and to provide a usage help with consistent look.</p></div> </div> </div> -<h2>Basics</h2> +<h2 id="_basics">Basics</h2> <div class="sectionbody"> -<p>The argument vector <tt>argv[]</tt> may usually contain mandatory or optional +<div class="para"><p>The argument vector <tt>argv[]</tt> may usually contain mandatory or optional <em>non-option arguments</em>, e.g. a filename or a branch, and <em>options</em>. Options are optional arguments that start with a dash and -that allow to change the behavior of a command.</p> -<ul> +that allow to change the behavior of a command.</p></div> +<div class="ilist"><ul> <li> <p> There are basically three types of options: @@ -298,9 +346,9 @@ Please define <em>lower-case long options</em> only. </p> </li> -</ul> -<p>The parse-options API allows:</p> -<ul> +</ul></div> +<div class="para"><p>The parse-options API allows:</p></div> +<div class="ilist"><ul> <li> <p> <em>sticked</em> and <em>separate form</em> of options with arguments. @@ -332,11 +380,11 @@ <tt>--this-is-a-file</tt> must not be processed as an option. </p> </li> -</ul> +</ul></div> </div> -<h2>Steps to parse options</h2> +<h2 id="_steps_to_parse_options">Steps to parse options</h2> <div class="sectionbody"> -<ol> +<div class="olist"><ol> <li> <p> <tt>#include "parse-options.h"</tt> @@ -364,11 +412,11 @@ <div class="content"> <pre><tt>argc = parse_options(argc, argv, builtin_foo_options, builtin_foo_usage, flags);</tt></pre> </div></div> -<p><tt>parse_options()</tt> will filter out the processed options of <tt>argv[]</tt> and leave the +<div class="para"><p><tt>parse_options()</tt> will filter out the processed options of <tt>argv[]</tt> and leave the non-option arguments in <tt>argv[]</tt>. -<tt>argc</tt> is updated appropriately because of the assignment.</p> -<p>Flags are the bitwise-or of:</p> -<dl> +<tt>argc</tt> is updated appropriately because of the assignment.</p></div> +<div class="para"><p>Flags are the bitwise-or of:</p></div> +<div class="vlist"><dl> <dt> <tt>PARSE_OPT_KEEP_DASHDASH</tt> </dt> @@ -388,16 +436,16 @@ argument. </p> </dd> -</dl> +</dl></div> </li> -</ol> +</ol></div> </div> -<h2>Data Structure</h2> +<h2 id="_data_structure">Data Structure</h2> <div class="sectionbody"> -<p>The main data structure is an array of the <tt>option</tt> struct, +<div class="para"><p>The main data structure is an array of the <tt>option</tt> struct, say <tt>static struct option builtin_add_options[]</tt>. -There are some macros to easily define options:</p> -<dl> +There are some macros to easily define options:</p></div> +<div class="vlist"><dl> <dt> <tt>OPT__ABBREV(&int_var)</tt> </dt> @@ -522,10 +570,10 @@ Introduce a long-option argument that will be kept in <tt>argv[]</tt>. </p> </dd> -</dl> -<p>The last element of the array must be <tt>OPT_END()</tt>.</p> -<p>If not stated otherwise, interpret the arguments as follows:</p> -<ul> +</dl></div> +<div class="para"><p>The last element of the array must be <tt>OPT_END()</tt>.</p></div> +<div class="para"><p>If not stated otherwise, interpret the arguments as follows:</p></div> +<div class="ilist"><ul> <li> <p> <tt>short</tt> is a character for the short option @@ -562,17 +610,17 @@ omitted at the end. </p> </li> -</ul> +</ul></div> </div> -<h2>Option Callbacks</h2> +<h2 id="_option_callbacks">Option Callbacks</h2> <div class="sectionbody"> -<p>The function must be defined in this form:</p> +<div class="para"><p>The function must be defined in this form:</p></div> <div class="literalblock"> <div class="content"> <pre><tt>int func(const struct option *opt, const char *arg, int unset)</tt></pre> </div></div> -<p>The callback mechanism is as follows:</p> -<ul> +<div class="para"><p>The callback mechanism is as follows:</p></div> +<div class="ilist"><ul> <li> <p> Inside <tt>funct</tt>, the only interesting member of the structure @@ -594,31 +642,31 @@ If the user negates the option, <tt>arg</tt> is <tt>NULL</tt> and <tt>unset</tt> is 1. </p> </li> -</ul> +</ul></div> </div> -<h2>Sophisticated option parsing</h2> +<h2 id="_sophisticated_option_parsing">Sophisticated option parsing</h2> <div class="sectionbody"> -<p>If you need, for example, option callbacks with optional arguments +<div class="para"><p>If you need, for example, option callbacks with optional arguments or without arguments at all, or if you need other special cases, that are not handled by the macros above, you need to specify the -members of the <tt>option</tt> structure manually.</p> -<p>This is not covered in this document, but well documented -in <tt>parse-options.h</tt> itself.</p> +members of the <tt>option</tt> structure manually.</p></div> +<div class="para"><p>This is not covered in this document, but well documented +in <tt>parse-options.h</tt> itself.</p></div> </div> -<h2>Examples</h2> +<h2 id="_examples">Examples</h2> <div class="sectionbody"> -<p>See <tt>test-parse-options.c</tt> and +<div class="para"><p>See <tt>test-parse-options.c</tt> and <tt>builtin-add.c</tt>, <tt>builtin-clone.c</tt>, <tt>builtin-commit.c</tt>, <tt>builtin-fetch.c</tt>, <tt>builtin-fsck.c</tt>, <tt>builtin-rm.c</tt> -for real-world examples.</p> +for real-world examples.</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:20 UTC +Last updated 2008-09-19 06:33:30 UTC </div> </div> </body> diff --git a/technical/api-quote.html b/technical/api-quote.html index b9d6fab..e58430a 100644 --- a/technical/api-quote.html +++ b/technical/api-quote.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>quote API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <quote.h>, things like</p> -<ul> +<div class="para"><p>Talk about <quote.h>, things like</p></div> +<div class="ilist"><ul> <li> <p> sq_quote and unquote @@ -280,13 +328,13 @@ quoting for foreign languages </p> </li> -</ul> -<p>(JC)</p> +</ul></div> +<div class="para"><p>(JC)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:21 UTC +Last updated 2008-09-19 06:33:31 UTC </div> </div> </body> diff --git a/technical/api-remote.html b/technical/api-remote.html index a33256a..1037f45 100644 --- a/technical/api-remote.html +++ b/technical/api-remote.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>Remotes configuration API</title> </head> @@ -263,16 +311,16 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The API in remote.h gives access to the configuration related to +<div class="para"><p>The API in remote.h gives access to the configuration related to remotes. It handles all three configuration mechanisms historically and currently used by git, and presents the information in a uniform fashion. Note that the code also handles plain URLs without any -configuration, giving them just the default information.</p> +configuration, giving them just the default information.</p></div> </div> </div> -<h2>struct remote</h2> +<h2 id="_struct_remote">struct remote</h2> <div class="sectionbody"> -<dl> +<div class="vlist"><dl> <dt> <tt>name</tt> </dt> @@ -338,34 +386,34 @@ The proxy to use for curl (http, https, ftp, etc.) URLs. </p> </dd> -</dl> -<p>struct remotes can be found by name with remote_get(), and iterated +</dl></div> +<div class="para"><p>struct remotes can be found by name with remote_get(), and iterated through with for_each_remote(). remote_get(NULL) will return the -default remote, given the current branch and configuration.</p> +default remote, given the current branch and configuration.</p></div> </div> -<h2>struct refspec</h2> +<h2 id="_struct_refspec">struct refspec</h2> <div class="sectionbody"> -<p>A struct refspec holds the parsed interpretation of a refspec. If it +<div class="para"><p>A struct refspec holds the parsed interpretation of a refspec. If it will force updates (starts with a <em>+</em>), force is true. If it is a pattern (sides end with <em>*</em>) pattern is true. src and dest are the two sides (if a pattern, only the part outside of the wildcards); if there is only one side, it is src, and dst is NULL; if sides exist but are empty (i.e., the refspec either starts or ends with <em>:</em>), the -corresponding side is "".</p> -<p>This parsing can be done to an array of strings to give an array of -struct refpsecs with parse_ref_spec().</p> -<p>remote_find_tracking(), given a remote and a struct refspec with +corresponding side is "".</p></div> +<div class="para"><p>This parsing can be done to an array of strings to give an array of +struct refpsecs with parse_ref_spec().</p></div> +<div class="para"><p>remote_find_tracking(), given a remote and a struct refspec with either src or dst filled out, will fill out the other such that the result is in the "fetch" specification for the remote (note that this -evaluates patterns and returns a single result).</p> +evaluates patterns and returns a single result).</p></div> </div> -<h2>struct branch</h2> +<h2 id="_struct_branch">struct branch</h2> <div class="sectionbody"> -<p>Note that this may end up moving to branch.h</p> -<p>struct branch holds the configuration for a branch. It can be looked -branch_get(NULL) for HEAD.</p> -<p>It contains:</p> -<dl> +<div class="para"><p>Note that this may end up moving to branch.h</p></div> +<div class="para"><p>struct branch holds the configuration for a branch. It can be looked +branch_get(NULL) for HEAD.</p></div> +<div class="para"><p>It contains:</p></div> +<div class="vlist"><dl> <dt> <tt>name</tt> </dt> @@ -424,19 +472,19 @@ The number of merge configurations </p> </dd> -</dl> -<p>branch_has_merge_config() returns true if the given branch has merge -configuration given.</p> +</dl></div> +<div class="para"><p>branch_has_merge_config() returns true if the given branch has merge +configuration given.</p></div> </div> -<h2>Other stuff</h2> +<h2 id="_other_stuff">Other stuff</h2> <div class="sectionbody"> -<p>There is other stuff in remote.h that is related, in general, to the -process of interacting with remotes.</p> -<p>(Daniel Barkalow)</p> +<div class="para"><p>There is other stuff in remote.h that is related, in general, to the +process of interacting with remotes.</p></div> +<div class="para"><p>(Daniel Barkalow)</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:21 UTC +Last updated 2008-09-19 06:33:31 UTC </div> </div> </body> diff --git a/technical/api-revision-walking.html b/technical/api-revision-walking.html index a450913..7f252a7 100644 --- a/technical/api-revision-walking.html +++ b/technical/api-revision-walking.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>revision walking API</title> </head> @@ -263,20 +311,20 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>The revision walking API offers functions to build a list of revisions -and then iterate over that list.</p> +<div class="para"><p>The revision walking API offers functions to build a list of revisions +and then iterate over that list.</p></div> </div> </div> -<h2>Calling sequence</h2> +<h2 id="_calling_sequence">Calling sequence</h2> <div class="sectionbody"> -<p>The walking API has a given calling sequence: first you need to +<div class="para"><p>The walking API has a given calling sequence: first you need to initialize a rev_info structure, then add revisions to control what kind of revision list do you want to get, finally you can iterate over the -revision list.</p> +revision list.</p></div> </div> -<h2>Functions</h2> +<h2 id="_functions">Functions</h2> <div class="sectionbody"> -<dl> +<div class="vlist"><dl> <dt> <tt>init_revisions</tt> </dt> @@ -344,12 +392,12 @@ revision list is indicated by returning a NULL pointer. </p> </dd> -</dl> +</dl></div> </div> -<h2>Data structures</h2> +<h2 id="_data_structures">Data structures</h2> <div class="sectionbody"> -<p>Talk about <revision.h>, things like:</p> -<ul> +<div class="para"><p>Talk about <revision.h>, things like:</p></div> +<div class="ilist"><ul> <li> <p> two diff_options, one for path limiting, another for output; @@ -360,12 +408,12 @@ remaining functions; </p> </li> -</ul> -<p>(Linus, JC, Dscho)</p> +</ul></div> +<div class="para"><p>(Linus, JC, Dscho)</p></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:22 UTC +Last updated 2008-09-19 06:33:32 UTC </div> </div> </body> diff --git a/technical/api-run-command.html b/technical/api-run-command.html index acbc323..2a5c07e 100644 --- a/technical/api-run-command.html +++ b/technical/api-run-command.html
@@ -612,7 +612,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 2008-07-20 01:23:36 UTC +Last updated 2008-09-19 06:33:32 UTC </div> </div> </body>
diff --git a/technical/api-setup.html b/technical/api-setup.html index 78475cb..0493e86 100644 --- a/technical/api-setup.html +++ b/technical/api-setup.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>setup API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about</p> -<ul> +<div class="para"><p>Talk about</p></div> +<div class="ilist"><ul> <li> <p> setup_git_directory() @@ -295,13 +343,13 @@ get_pathspec() </p> </li> -</ul> -<p>(Dscho)</p> +</ul></div> +<div class="para"><p>(Dscho)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:22 UTC +Last updated 2008-09-19 06:33:33 UTC </div> </div> </body> diff --git a/technical/api-strbuf.html b/technical/api-strbuf.html index 1bcc895..ff25628 100644 --- a/technical/api-strbuf.html +++ b/technical/api-strbuf.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>strbuf API</title> </head> @@ -263,27 +311,27 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>strbuf's are meant to be used with all the usual C string and memory +<div class="para"><p>strbuf's are meant to be used with all the usual C string and memory APIs. Given that the length of the buffer is known, it's often better to use the mem* functions than a str* one (memchr vs. strchr e.g.). Though, one has to be careful about the fact that str* functions often -stop on NULs and that strbufs may have embedded NULs.</p> -<p>An strbuf is NUL terminated for convenience, but no function in the -strbuf API actually relies on the string being free of NULs.</p> -<p>strbufs has some invariants that are very important to keep in mind:</p> -<ol> +stop on NULs and that strbufs may have embedded NULs.</p></div> +<div class="para"><p>An strbuf is NUL terminated for convenience, but no function in the +strbuf API actually relies on the string being free of NULs.</p></div> +<div class="para"><p>strbufs has some invariants that are very important to keep in mind:</p></div> +<div class="olist"><ol> <li> <p> The <tt>buf</tt> member is never NULL, so you it can be used in any usual C string operations safely. strbuf's _have_ to be initialized either by <tt>strbuf_init()</tt> or by <tt>= STRBUF_INIT</tt> before the invariants, though. </p> -<p>Do <strong>not</strong> assume anything on what <tt>buf</tt> really is (e.g. if it is +<div class="para"><p>Do <strong>not</strong> assume anything on what <tt>buf</tt> really is (e.g. if it is allocated memory or not), use <tt>strbuf_detach()</tt> to unwrap a memory buffer from its strbuf shell in a safe way. That is the sole supported -way. This will give you a malloced buffer that you can later <tt>free()</tt>.</p> -<p>However, it it totally safe to modify anything in the string pointed by -the <tt>buf</tt> member, between the indices <tt>0</tt> and <tt>len-1</tt> (inclusive).</p> +way. This will give you a malloced buffer that you can later <tt>free()</tt>.</p></div> +<div class="para"><p>However, it it totally safe to modify anything in the string pointed by +the <tt>buf</tt> member, between the indices <tt>0</tt> and <tt>len-1</tt> (inclusive).</p></div> </li> <li> <p> @@ -306,7 +354,7 @@ <pre><tt>strbuf_grow(sb, SOME_SIZE); <b>(1)</b> strbuf_setlen(sb, sb->len + SOME_OTHER_SIZE);</tt></pre> </div></div> -<ol> +<div class="colist"><ol> <li> <p> Here, the memory array starting at <tt>sb->buf</tt>, and of length @@ -321,8 +369,8 @@ <td class="content"><tt>SOME_OTHER_SIZE</tt> must be smaller or equal to <tt>strbuf_avail(sb)</tt>.</td> </tr></table> </div> -<p>Doing so is safe, though if it has to be done in many places, adding the -missing API to the strbuf module is the way to go.</p> +<div class="para"><p>Doing so is safe, though if it has to be done in many places, adding the +missing API to the strbuf module is the way to go.</p></div> <div class="admonitionblock"> <table><tr> <td class="icon"> @@ -335,32 +383,32 @@ </tr></table> </div> </li> -</ol> +</ol></div> </li> -</ol> +</ol></div> </div> </div> -<h2>Data structures</h2> +<h2 id="_data_structures">Data structures</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> <tt>struct strbuf</tt> </p> </li> -</ul> -<p>This is string buffer structure. The <tt>len</tt> member can be used to +</ul></div> +<div class="para"><p>This is string buffer structure. The <tt>len</tt> member can be used to determine the current length of the string, and <tt>buf</tt> member provides access to -the string itself.</p> +the string itself.</p></div> </div> -<h2>Functions</h2> +<h2 id="_functions">Functions</h2> <div class="sectionbody"> -<ul> +<div class="ilist"><ul> <li> <p> Life cycle </p> -<dl> +<div class="vlist"><dl> <dt> <tt>strbuf_init</tt> </dt> @@ -410,13 +458,13 @@ Swap the contents of two string buffers. </p> </dd> -</dl> +</dl></div> </li> <li> <p> Related to the size of the buffer </p> -<dl> +<div class="vlist"><dl> <dt> <tt>strbuf_avail</tt> </dt> @@ -457,13 +505,13 @@ Empty the buffer by setting the size of it to zero. </p> </dd> -</dl> +</dl></div> </li> <li> <p> Related to the contents of the buffer </p> -<dl> +<div class="vlist"><dl> <dt> <tt>strbuf_rtrim</tt> </dt> @@ -482,14 +530,14 @@ to match, or be greater than the second buffer. </p> </dd> -</dl> +</dl></div> </li> <li> <p> Adding data to the buffer </p> </li> -</ul> +</ul></div> <div class="admonitionblock"> <table><tr> <td class="icon"> @@ -499,7 +547,7 @@ necessary.</td> </tr></table> </div> -<dl> +<div class="vlist"><dl> <dt> <tt>strbuf_addch</tt> </dt> @@ -562,7 +610,7 @@ <div class="content"> <pre><tt>strbuf_add(..., s, strlen(s));</tt></pre> </div></div> -<p>Meaning that this is efficient to write things like:</p> +<div class="para"><p>Meaning that this is efficient to write things like:</p></div> <div class="listingblock"> <div class="content"> <pre><tt>strbuf_addstr(sb, "immediate string");</tt></pre> @@ -594,18 +642,18 @@ placeholders. To that end, it parses the string and calls the specified function for every percent sign found. </p> -<p>The callback function is given a pointer to the character after the <tt>%</tt> +<div class="para"><p>The callback function is given a pointer to the character after the <tt>%</tt> and a pointer to the struct strbuf. It is expected to add the expanded version of the placeholder to the strbuf, e.g. to add a newline character if the letter <tt>n</tt> appears after a <tt>%</tt>. The function returns the length of the placeholder recognized and <tt>strbuf_expand()</tt> skips -over it.</p> -<p>All other characters (non-percent and not skipped ones) are copied +over it.</p></div> +<div class="para"><p>All other characters (non-percent and not skipped ones) are copied verbatim to the strbuf. If the callback returned zero, meaning that the -placeholder is unknown, then the percent sign is copied, too.</p> -<p>In order to facilitate caching and to make it possible to give +placeholder is unknown, then the percent sign is copied, too.</p></div> +<div class="para"><p>In order to facilitate caching and to make it possible to give parameters to the callback, <tt>strbuf_expand()</tt> passes a context pointer, -which can be used by the programmer of the callback as she sees fit.</p> +which can be used by the programmer of the callback as she sees fit.</p></div> </dd> <dt> <tt>strbuf_addf</tt> @@ -674,14 +722,12 @@ <tt>launch_editor</tt> </dt> <dd> -<p> -</p> </dd> -</dl> +</dl></div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:22 UTC +Last updated 2008-09-19 06:33:33 UTC </div> </div> </body> diff --git a/technical/api-string-list.html b/technical/api-string-list.html index 05ce239..bb59d38 100644 --- a/technical/api-string-list.html +++ b/technical/api-string-list.html
@@ -534,7 +534,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 2008-07-24 04:02:44 UTC +Last updated 2008-09-19 06:33:33 UTC </div> </div> </body>
diff --git a/technical/api-tree-walking.html b/technical/api-tree-walking.html index 3b4d51c..7e43029 100644 --- a/technical/api-tree-walking.html +++ b/technical/api-tree-walking.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>tree walking API</title> </head> @@ -263,8 +311,8 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about <tree-walk.h>, things like</p> -<ul> +<div class="para"><p>Talk about <tree-walk.h>, things like</p></div> +<div class="ilist"><ul> <li> <p> struct tree_desc @@ -290,13 +338,13 @@ get_tree_entry </p> </li> -</ul> -<p>(JC, Linus)</p> +</ul></div> +<div class="para"><p>(JC, Linus)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:22 UTC +Last updated 2008-09-19 06:33:34 UTC </div> </div> </body> diff --git a/technical/api-xdiff-interface.html b/technical/api-xdiff-interface.html index bcb0c87..e60c323 100644 --- a/technical/api-xdiff-interface.html +++ b/technical/api-xdiff-interface.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 7.0.2" /> +<meta name="generator" content="AsciiDoc 8.2.5" /> <style type="text/css"> /* Debug borders */ p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 { @@ -16,8 +16,13 @@ margin: 1em 5% 1em 5%; } -a { color: blue; } -a:visited { color: fuchsia; } +a { + color: blue; + text-decoration: underline; +} +a:visited { + color: fuchsia; +} em { font-style: italic; @@ -39,13 +44,18 @@ line-height: 1.3; } -h1 { +h1, h2, h3 { border-bottom: 2px solid silver; } h2 { - border-bottom: 2px solid silver; padding-top: 0.5em; } +h3 { + float: left; +} +h3 + * { + clear: left; +} div.sectionbody { font-family: serif; @@ -70,7 +80,7 @@ color: #527bbd; font-family: sans-serif; font-weight: bold; - font-size: 1.2em; + font-size: 1.1em; } span#email { } @@ -139,6 +149,9 @@ padding: 0.5em; } +div.listingblock { + margin-right: 0%; +} div.listingblock > div.content { border: 1px solid silver; background: #f4f4f4; @@ -148,9 +161,13 @@ div.quoteblock > div.content { padding-left: 2.0em; } -div.quoteblock .attribution { + +div.attribution { text-align: right; } +div.verseblock + div.attribution { + text-align: left; +} div.admonitionblock .icon { vertical-align: top; @@ -194,13 +211,12 @@ ul, ol { list-style-position: outside; } -ol.olist2 { +div.olist2 ol { list-style-type: lower-alpha; } div.tableblock > table { - border-color: #527bbd; - border-width: 3px; + border: 3px solid #527bbd; } thead { font-family: sans-serif; @@ -214,6 +230,9 @@ margin-top: 0.8em; margin-bottom: 0.8em; } +div.hlist td { + padding-bottom: 5px; +} td.hlist1 { vertical-align: top; font-style: italic; @@ -226,6 +245,32 @@ @media print { div#footer-badges { display: none; } } + +div#toctitle { + color: #527bbd; + font-family: sans-serif; + font-size: 1.1em; + font-weight: bold; + margin-top: 1.0em; + margin-bottom: 0.1em; +} + +div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { + margin-top: 0; + margin-bottom: 0; +} +div.toclevel2 { + margin-left: 2em; + font-size: 0.9em; +} +div.toclevel3 { + margin-left: 4em; + font-size: 0.9em; +} +div.toclevel4 { + margin-left: 6em; + font-size: 0.9em; +} /* Workarounds for IE6's broken and incomplete CSS2. */ div.sidebar-content { @@ -254,6 +299,9 @@ border-left: 2px solid silver; padding-left: 0.5em; } + +/* IE6 sets dynamically generated links as visited. */ +div#toc a:visited { color: blue; } </style> <title>xdiff interface API</title> </head> @@ -263,14 +311,14 @@ </div> <div id="preamble"> <div class="sectionbody"> -<p>Talk about our calling convention to xdiff library, including -xdiff_emit_consume_fn.</p> -<p>(Dscho, JC)</p> +<div class="para"><p>Talk about our calling convention to xdiff library, including +xdiff_emit_consume_fn.</p></div> +<div class="para"><p>(Dscho, JC)</p></div> </div> </div> <div id="footer"> <div id="footer-text"> -Last updated 02-Jul-2008 03:02:23 UTC +Last updated 2008-09-19 06:33:34 UTC </div> </div> </body> 